Skip to main content

XP Tables Config

Summary

XP Tables are a Level/Quantity mapping. Their primary use is to be assigned to an item that has a Level Vendor.

Progression Rewards

When an item that has a Level Vendor is granted (e.g. add 100 of a "player progression" item), the before/after owned quantity is calculated for the player. That range is then compared against the "Sort Order" on the Level Vendor's Loot records. If a loot record's Sort Order falls between, it is granted to the player. (Sort Order 0 is granted for each quantity).

This works fine for an initial setup, but can be a bit confusing to manage the level reward vendor. For example, if your level system looks something like this:

  1. 100 xp
  2. 500 xp
  3. 1500 xp

The non-linear progression makes looking at the Loot's sort order, and knowing which level they are associated with difficult.

This is where XP Tables can be used. If an XP table was set up with the above mapping, the Loot in the Level Vendor can be configured with 1,2,3 instead of 100,500,1500 - which is much easier to manage.

Shared Progression

In addition to the above use-case, it is common for progression tracks to be shared in a game. For example a game with multiple characters that have a progression. Tracking the quantities in each Reward Vendor is a bit cumbersome. Instead, you can set up an XP Table for "Character Progression", and reuse it for multiple character items (and their associated Reward Vendors).

XP Tables Config Schema

NameTypeRequiredDescription
custom_dataobjectNoCustom data associated with the resource
namestringNoName of the resource
descriptionstringNoDescription of the resource
xp_thresholdsarrayNoThe XP Thresholds.
sandbox_idstringNoID of the Sandbox
last_modified_account_idstringNoAccount ID of the user who last modified the resource
last_modified_timestampstringNoTimestamp of when the resource was last modified
created_timestampstringNoTimestamp of when the resource was created
xp_idstringYesThe ID of the XP.
legacy_xp_idintegerYesThe legacy ID of the XP.